chore(logs): update SDK onboarding pages #104234

JoshuaMoelans · 2025-12-02T13:55:41Z

Continuing from #102398, to be merged after that one was merged.

We add the logs onboarding for each of the platforms that now support logs (unity, unreal, dotnet, native, php-symfony)

ToDo

add Unity onboarding
double-check that all relevant onboarding docs exist & are correct (I will ping the SDK maintainers)
maybe add logs checkbox to project onboarding page for each of these SDKs (see original comment)

codecov · 2025-12-02T14:55:17Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@             Coverage Diff             @@
##           master   #104234      +/-   ##
===========================================
- Coverage   80.60%    80.60%   -0.01%     
===========================================
  Files        9333      9333              
  Lines      398600    398597       -3     
  Branches    25497     25496       -1     
===========================================
- Hits       321275    321272       -3     
  Misses      76875     76875              
  Partials      450       450

priscilawebdev · 2025-12-03T10:35:36Z

static/app/gettingStartedDocs/unreal/logs.tsx

+import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/types';
+import {t, tct} from 'sentry/locale';
+
+type Params = DocsParams;


we can use the DocsParams directly instead of using type Params

static/app/gettingStartedDocs/unreal/index.tsx

static/app/gettingStartedDocs/unreal/onboarding.tsx

static/app/gettingStartedDocs/unity/onboarding.tsx

priscilawebdev · 2025-12-03T10:44:29Z

static/app/data/platformCategories.tsx

+  'cocoa-objc',
+  'cocoa-swift',


I noticed that we have several references to these platforms in the codebase, but we don’t present them as options when users create a project. My understanding is that users can also create projects through the public API - Is that why we need to include these platforms here?

yeah seems like it, they were also added to some other categories for backwards compatability #84768

getsantry · 2025-12-25T08:00:19Z

This issue has gone three weeks without activity. In another week, I will close it.

But! If you comment or otherwise update it, I will reset the clock, and if you remove the label Waiting for: Community, I will leave it alone ... forever!

"A weed is but an unloved flower." ― Ella Wheeler Wilcox 🥀

- fix link - add minidump storage setting

…gs-only (#105563)

priscilawebdev · 2026-01-12T07:37:39Z

static/app/gettingStartedDocs/unreal/logs.tsx

+    {
+      type: StepType.VERIFY,
+      content: [
+        {
+          type: 'text',
+          text: t(
+            'Once structured logging is enabled, you can send logs using the AddLog method on the Sentry subsystem.'
+          ),
+        },
+        {
+          type: 'code',
+          language: 'cpp',
+          code: `USentrySubsystem* SentrySubsystem = GEngine->GetEngineSubsystem<USentrySubsystem>();
+
+// Send logs at different severity levels
+SentrySubsystem->AddLog(TEXT("A simple log message"), ESentryLevel::Info, TEXT("GameFlow"));
+SentrySubsystem->AddLog(TEXT("Failed to save game data"), ESentryLevel::Error, TEXT("SaveSystem"));`,
+        },
+        {
+          type: 'text',
+          text: tct(
+            'You can also automatically capture Unreal Engine [code:UE_LOG] calls. For more information, see the [link:Automatic UE_LOG Integration documentation].',
+            {
+              code: <code />,
+              link: (
+                <ExternalLink href="https://docs.sentry.io/platforms/unreal/logs/#automatic-ue_log-integration" />
+              ),
+            }
+          ),
+        },
+      ],
+    },


we currently repeat this exact text in onboarding.tsx. I’m wondering if it would be better to move it to unreal/utils.tsx (needs to be created) and reuse it. That would make maintenance easier.

priscilawebdev · 2026-01-12T07:41:07Z

static/app/gettingStartedDocs/unity/onboarding.tsx

+              text: tct(
+                'To enable structured logging, check the [code:Enable Logs] option in the Sentry configuration window.',
+                {code: <code />}


do we need this? I notice that the code snippet already gets updated when "logs" is checked

priscilawebdev · 2026-01-12T07:43:12Z

static/app/gettingStartedDocs/unreal/logs.tsx

+        {
+          type: 'text',
+          text: t(
+            'Once structured logging is enabled, you can send logs using the AddLog method on the Sentry subsystem.'
+          ),
+        },
+        {
+          type: 'code',
+          language: 'cpp',
+          code: `USentrySubsystem* SentrySubsystem = GEngine->GetEngineSubsystem<USentrySubsystem>();


Rather than adding a separate section just for logs, shouldn’t we update the verify code snippet to include the log’s code? javascript-react is doing that for example

priscilawebdev · 2026-01-12T07:48:34Z

static/app/gettingStartedDocs/native/onboarding.tsx

  sentry_options_set_dsn(options, "${params.dsn.public}");
  // This is also the default-path. For further information and recommendations:
-  // https://docs.sentry.io/platforms/native/configuration/options/#database-path
+  // https://docs.sentry.io/platforms/native/configuration/options/#database_path


good catch here!

priscilawebdev · 2026-01-12T07:50:08Z

static/app/gettingStartedDocs/native/onboarding.tsx

+    {
+      title: t('Further Settings'),
+      content: [
+        {
+          type: 'custom',
+          content: (
+            <StoreCrashReportsConfig
+              organization={params.organization}
+              projectSlug={params.project.slug}
+            />
+          ),
+        },
+      ],
+    },


should this be in a separate PR or its related?

priscilawebdev · 2026-01-12T07:52:17Z

static/app/gettingStartedDocs/native/logs.tsx

+            {
+              link: (
+                <ExternalLink href="https://github.com/getsentry/sentry-native/releases/tag/0.11.1" />
+              ),
+            }


when mentioning versions, why do provide a link only here? asking because I did not see that for dotnet too.

priscilawebdev · 2026-01-12T07:53:10Z

static/app/gettingStartedDocs/dotnet/logs.tsx

+        {
+          type: 'text',
+          text: t(
+            'Once the feature is enabled on the SDK and the SDK is initialized, you can send logs using the SentrySdk.Logger APIs.'


Suggested change

'Once the feature is enabled on the SDK and the SDK is initialized, you can send logs using the SentrySdk.Logger APIs.'

'Once the feature is enabled and the SDK is initialized, you can send logs using the SentrySdk.Logger APIs.'

priscilawebdev · 2026-01-12T07:55:27Z

static/app/components/onboarding/productSelection.tsx

+    ProductSolution.PROFILING,
+    ProductSolution.LOGS,
+  ],
  'dotnet-aspnet': [ProductSolution.PERFORMANCE_MONITORING],


are we going to add LOGS here and other platforms afterwards? Just noticed that it's "new" in our docs https://docs.sentry.io/platforms/dotnet/guides/aspnet/logs/

github-actions bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Dec 2, 2025

vercel bot deployed to Preview December 2, 2025 13:56 View deployment

JoshuaMoelans mentioned this pull request Dec 2, 2025

fix(logs): update withoutLoggingSupport to remove platforms which support logs #102398

Merged

JoshuaMoelans changed the title ~~Joshua/chore/logs onboarding~~ chore: update SDK onboarding pages Dec 2, 2025

vercel bot deployed to Preview December 2, 2025 14:47 View deployment

vercel bot deployed to Preview December 2, 2025 14:52 View deployment

vercel bot deployed to Preview December 2, 2025 15:34 View deployment

priscilawebdev reviewed Dec 3, 2025

View reviewed changes

getsantry bot added the Stale label Dec 25, 2025

vercel bot deployed to Preview December 30, 2025 14:27 View deployment

vercel bot deployed to Preview December 30, 2025 14:30 View deployment

getsantry bot removed the Stale label Dec 31, 2025

vercel bot deployed to Preview December 31, 2025 08:43 View deployment

vercel bot deployed to Preview December 31, 2025 10:06 View deployment

JoshuaMoelans changed the title ~~chore: update SDK onboarding pages~~ chore(logs): update SDK onboarding pages Dec 31, 2025

JoshuaMoelans mentioned this pull request Dec 31, 2025

chore(tracing): update SDK onboarding pages #105564

Draft

JoshuaMoelans added 2 commits January 9, 2026 13:27

add to withLoggingOnboarding

2a795b8

add native logs onboarding

3d3fc0e

vercel bot deployed to Preview January 9, 2026 12:27 View deployment

JoshuaMoelans added 7 commits January 9, 2026 13:30

Add logs onboarding for dotnet, symfony and unreal

60afa60

add tracing to native/unity/unreal

bcf6099

fixup native onboarding

7403592

- fix link - add minidump storage setting

add mock for native onboarding

25d3f70

use DocsParams directly

cb211a3

chore(cleanup): remove tracing-related content to keep original PR lo…

0219a37

…gs-only (#105563)

further performace_monitoring cleanup

f3a368a

JoshuaMoelans force-pushed the joshua/chore/logs_onboarding branch from 8411a74 to f3a368a Compare January 9, 2026 12:31

vercel bot deployed to Preview January 9, 2026 12:33 View deployment

add/fix logs onboarding

b3fe2f9

vercel bot deployed to Preview January 9, 2026 12:57 View deployment

JoshuaMoelans marked this pull request as ready for review January 9, 2026 13:22

JoshuaMoelans requested a review from a team as a code owner January 9, 2026 13:22

JoshuaMoelans requested review from Flash0ver, Litarnus, bitsandfoxes and priscilawebdev January 9, 2026 13:23

priscilawebdev reviewed Jan 12, 2026

View reviewed changes

	'Once the feature is enabled on the SDK and the SDK is initialized, you can send logs using the SentrySdk.Logger APIs.'
	'Once the feature is enabled and the SDK is initialized, you can send logs using the SentrySdk.Logger APIs.'

Uh oh!

chore(logs): update SDK onboarding pages #104234

Are you sure you want to change the base?

chore(logs): update SDK onboarding pages #104234

Uh oh!

Conversation

JoshuaMoelans commented Dec 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Dec 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

JoshuaMoelans Dec 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

getsantry bot commented Dec 25, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

JoshuaMoelans commented Dec 2, 2025 •

edited

Loading

codecov bot commented Dec 2, 2025 •

edited

Loading

JoshuaMoelans Dec 30, 2025 •

edited

Loading